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FlexNet-Kernel 


This is the central FlexNet module. It must always be loaded first. It may be 
used in conjunction with FLEXDIGI, if digipeater services are required. 

All FlexNet channel drivers are supported. There may be up to 15 channels, 
which should suffice for all purposes. 


= Hardware and software requirements 
PC/XT or preferably AT with at least 256 kB RAM 
PC/FlexNet needs about 60 kB RAM plus the RAM needed for channel 
drivers and utilities. 

- Operating system 
MS-DOS version 3.1 or later, preferably 5.0 or 6.2, where parts of 
the package may be loaded into the UMBs 

- Interfaces 
as required (see available channel drivers) 


- A PC/XT should basically suffice. The achievable data rate depends largely 
on the speed and throughput of the channel drivers. 


= Tests with MS-DOS 6.0 showed problems, and there is no experience with 
DR-DOS. The author suggests the use of MS-DOS 5.0 or 6.2. This allows 

the modules to be loaded into UMBs if there is sufficent memory. 

EMM386 or foreground programs with virtual memory management may in some 
cases lead to loss of data on the channels, but this depends largely on 
the computer and the channel drivers that are used. 


- To load the modules (with MS-DOS 5.0 or later), use "LOADHIGH" or "LH", 
it doesn't hurt; if there is not enough memory in the UMBs, the modules 
are loaded into the conventional memory. Even in this case memory can be 
saved, since the environment block does not leave a gap in the memory. 
"MEM /D" shows the memory usage. 


= PC/FlexNet supports loadable L1 drivers (or channel drivers). They are 
installed in memory simply by calling them. Therefore it is very easy to 
support any interface. A "driver kit" is available for interested 
developers. 


- Channel numbers are allocated in ascending order of the driver 
installation. A driver may support any number of channels. FlexNet however 
supports at most 15 channels. 


= The whole installation is usually done with a batch file, because most 
channel drivers need command line parameters. Error conditions are 
reported back to COMMAND.COM, and the batch file should terminate the 
installation. 


FLEXNET.EXE must always be loaded first. Then the channel drivers 

should be called in the desired order. Then the modules must be activated 
by calling the utility "FLEX". After activation, channel driver 
installation is refused. Now, channel parameters must be set up using 
the "FSET" utility. The mode parameter is driver dependent and may be 
£ 
W 
A 


ound in the driver documentation or the online help, which is displayed 
ith "<driver name> /?". 

pplications (terminal programs and so on) or the hostmode emulator TFEMU 
may now be loaded. 


= The size of the used data memory may be specified as an optional command 
line parameter to FLEXNET.EXE. A reasonable minimum is 15 kB per active 
channel. If there are many QSOs (for example BBS), there should be at least 
30-40 kB, more does not hurt. 


7 Channel drivers are included in the package if available. Every channel 
driver comes with a .DOC file with the same name that explains its 
installation. Every driver also displays a short help text if called with 
/? that explains its parameters. 


- FLEXNET.EXE, the channel drivers and other extensions may be deinstalled 
by calling "FLEX.EXE /U". DOS however requires that there were no other 
TSRs loaded after FLEXNET, otherwise the machine may crash. 


- New in version 3.3e: An integrated multi channel digipeater. The call 
sign is entered with "FSET" (see below). The output channel is built 
from the digi SSID by adding the desired channel number. Now it is 
possible to build cross channel gateways without the need for the full 
featured FLEXDIGI node. 


An example batch file to start the PC/FlexNet package follows (comments at the 
end of the lines after the * must be omitted!) 


D>>>>>>>>>>>>>>>>>>>>>>>>>>>>> cut here <<<<<<<<<<<<<< << << << <<< KK KK 


1H FLEXNET 20 * Kernel with 20kB data memory 

if errorlevel 1 goto end * optional: if already installed, give up! 

1H SER12 2 * channel 0: BayCom serial modem at COM2 

if errorlevel 1 goto error * optional: if an error occured, give up! 

LH KISS 1 * channel 1: KISS mode to connect a computer at COM1 
if errorlevel 1 goto error * optional: if an error occured, give up! 

FLEX * activate the kernel and the channel drivers 

FSET mode 0 1200c * mode channel 0: 1200 baud half duplex, soft DCD 
FSET txd 0 15 * txdelay channel O 150ms 

FSET mode 1 38400cd * mode channel 1: 38400 baud full duplex, CRC mode 
FSET digi AC5SFC * optional: set digipeater callsign 

LH TFEMU * optional: start hostmode emulator 

goto end 

:error 

FLEX /u * if an error occured, unload the rest 

send 


D>>>>>>>>>>>>>>>>>>>>>>>>>>>>> cut here <<<<<<<<<<<<<< << << << <<< KK KKK 


Optionally, futher resident applications may be started, s the accompanying 
documentation. 


At last the forground application may be started if needed. The kernel 
stays active even if the application is terminated. 


The whole package may be unloaded with "FLEX /U". 


- If FLEXNET is used as a non-digipeater (i.e. without loading FLEXDIGI), 
only one channel is used normally, so the port needs not be specified. 
If there are multiple channels, the following should be noticed: 


The default channel for outgoing connects is channel 0. If another 
channel should be used, the channel number must be specified as first 
digipeater, for example: 

"CONNECT DBOODW 1" 


or 


"CONNECT DK7WJ via 1 DBOODW" 
The "via" is optinal, as usual. 


The applications determines if the port number of incoming connects 
is used or displayed. 


- Digipeating: If the given digi callsign is AC5FC-3, a frame "via AC5FC-3" 
will be output on channel 0, "via AC5FC-4" will come out on channel 
1 and so on. 


Useful utilities: 


FSET Sets channel parameters (TX Delays and baud rates etc) 
SHOW Traces channels and displays the channel states (PTT/DCD) 
STAT Displays channel statistics 

CALIB Switches the calibration mode on and off 


Every utility displays a command line parameter help if called with "/?". 


If you have questions or problems, please contact first the one from whom 

you got the package. Often, the local packet node sysop may help, especially 
if it is a FlexNet node. 

Please contact the author only if the above failed, by sending a mail to 

DK7WJ @DBOZDF. The answer may take a few days. If questions are asked that are 
answered sufficiently in the documentation or that can be found by 
experimenting, the mail may fall into the bit bucket. 


This software package is distributed freely. If you like the package and you 
want to support the work of the FlexNet group, a donation is welcome. 

The money will be used for further hardware and software development for 
RMNC and FlexNet. 
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Note: This is a translation of the german legal terms. It is for informational 
purposes only, they have, however, no legal significance. The german terms 
are the only applicable terms. 


The following legal terms govern the use of PC/FlexNet and its modules. 
Different modules from other authors may use different terms, which should 
be read in the documentation of the modules! 


= RMNC/FlexNet, PC/FlexNet and the accompanying utilities and documentations 
are a product of Gunter Jost, DK7WJ. Exceptions are marked. All rights 
remain at the author. The user has the right to use the software under 
the following conditions: 


- The software may only be used noncommercially for amateur radio. Every 
other use, especially in other radio services, needs in every case th 
written consent of the author. 


= The legal regulations concerning amateur radio are met. 


= Commercial copying and selling without the written consent of the 
author is prohibited. Also, the software must not be bundled with 
commercially sold components (for example modems) without the 
written consent of the author. In every case the customer must be 
informed in writing that he does not acquire further rights concerning 
the software. 


i The software must not be patched or changed. Changing parameters 
however is allowed. 


iS Copyright notices must not be removed or changed from the software 
modules and documentation. 


= The software must not, neither in part nor wholly, published over 
PBBS systems or publicly accessible mailboxes. 


= The software may be distributed freely. One must, however, always 
distribute the complete package, without any change. 
File dates and times must not be changed, so that different versions 
can easily be distinguished. 
Own extensions have to be clearly marked, at least with the callsign. 
(Note: This paragraph does not apply to the network node version!) 


= The authors or distributors of this software assume no responsibility 
or liability for any harm that results from using this software. 


The use of this software implies accepting the above legal terms. 


